The 640 MEG Shareware Studio 2/The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO/menu/daag310.zip/DAAG.DOC

Text File | 1992-10-06 | 17KB | 375 lines

Problem       : What is eating up all the space on my disk?
-------

Solution      : DAAG (Disk-at-a-Glance)  Version 3.10, Oct 1992
-------

Purpose       : - To provide a tree structured directory "map" of your
-------           hard disk(s), with Directory Sizes and Branch Sizes!

                - To make it easy to Change Directories
                  (never type "CD\... " again!)

                - Printed Report helps you know "What's installed where?"
                  Useful for Corporate Customers to track software
                  installed on multiple machines.

        ========================= Key Features ============================
        |  *  Tree-structured Directory Map with Directory & Branch Sizes |
        |  *  Quickly LOCATE directory by typing in partial name          |
        |  *  Useful statistics relating to File and Directory Size       |
        |  *  "Drill Down" gives useful summary of File Extensions        |
        |  *  Quickly Change Directory / Logical Drive                    |
        |  *  Shows Hidden Directories                                    |
        |  *  3 Piecharts and Bar Graphs (need EGA or VGA!)               |
        |  *  Contains a file BROWSE program (SHOW.EXE)                   |
        |  *  Includes a graphic front end program (DFE)                  |
        |  *  Can "launch" programs without taking up any extra memory!   |
        |  *  Printed Report helps inventory installed software           |
        |  *  Handles up to 5000 directories!                             |
        |  *  Mouse Aware - can even "type" in run parms with the Mouse   |
        ===================================================================

Installation : Simply copy DAAG.EXE, DFE.EXE, and SHOW.EXE into any directory
------------   in your PATH.

               Type "DAAG" at the DOS prompt; then READ THE SCREEN!


                        Moving through the Tree Map
                        ---------------------------

Use the UP and DOWN ARROW KEYS, PGUP, PGDN, HOME, and END to scroll
through the directory map.

Alternately, type part of the directory name, and the light bar will jump
to that directory as you type.

If your system is equipped with a mouse, you can move the mouse cursor to
the desired directory and click the Left Button, or click on the up and
down arrow pointers located at the ends of the Scroll Bars.

If you are using a mouse, you can click on amy of the Function Key literals
on the bottom line (hint line) of your screen.

These keys and their functions are summarized below:


                     Notes on the Scrolling Tree Map
                     -------------------------------

 -  The "AO date"  is the date that the Tree Map file was last generated.
    You should periodically regenerate this file with the F7 key.

 -  Hidden directories will appear with an "(H)" following the directory name.

 -  The Cumulative size column for any directory refers to the number of
    bytes in all the child directories of THAT directory, plus the number
    of bytes in the directory itself. If the directory has no subdirectories,
    then the cumulative value is left blank (since it is the same as the
    directory).

 -  The "% of disk" column indicates what percent of the Total Disk is used
    by each directory.

    However, on the Pie Charts, each slice represents which percent of the
    "used disk space" is taken up by a directory. This is required so that
    the Pie Chart percents will always add up (approximately, due to rounding)
    to 100%.

                     F2 - To Change to Another Drive
                     -------------------------------

Hitting F2 from the main window will present you with a list of other
available logical disk drives (Note "A" and "B" are not included).

Use the arrow keys to select a drive and hit enter, -or-
type the drive letter, -or- click on the desired letter to change to
the requested disk drive.

                      F3, F4, F5: PIECHARTS & GRAPHS
                      ------------------------------

Hit F3 to get a piechart of the top 16 directories by number of bytes
of disk used. If you have more than 16 directories, then the smallest
ones are grouped collectively under "Other".

F4 produces a similar piechart, however, only the FIRST LEVEL directories
are shown. This means that only the directories that are directly under
the Root Directory are shown. The file sizes for each include ALL the
subdirectories under the first level directory.

F5 produces a piechart similar to the F3 option, but considers only the
current BRANCH (hilighted directory AND all subdirectories under it).
Hitting F5 with the light bar on the Root Directory produces a pie chart
identical to that of hitting F3.

Regardless of which pie chart is selected, hitting Enter or Escape, or
clicking either Mouse button takes you to the BAR GRAPHS screen.

                         Purpose of the BAR GRAPHS
                         -------------------------

The piecharts show "the top 15" directories, as far as being space hogs.
(Everything else is lumped together under "All Other"). When you get a
hard disk with 200 or more directories, the ALL OTHER gets too big, and
every other "slice" is too small.

The BAR graphs show ALL directories, but only about 50 can be seen at
a time (or the directory names start to collide). The density of the
bars graphs is controlled by F3 (increase by 5) and F4 (decrease by 5).

If the biggest directory is much larger than the others, then the graph
scale range is only good when seeing that big directory. As soon as you
shift right, the scale is readjusted so that the biggest directory in the
group you are currently looking at takes up the whole scale.

Note that this screen shows ALL DIRECTORIES for the type of pie chart
selected (All, First Level , or Branch).

Hit or click the Left and Right Arrow Keys to shift the bar graph left or
right 1 bar at a time. Hit CTRL + Left or CTRL + Right to shift left and
right 5 bars at a time.

Use the UP and Down arrows (or click the  up/down icon) to shift the graph
up and down, allowing more or less of the directory names to show.

Hit ENTER, ESCAPE, or click the Exit button to return to the Tree Map.

The piecharts and graphs require an EGA or VGA monitor.

                              ENTER - Drill Down
                              ------------------

Hitting ENTER (Drill Down) from the main screen will give you a summary of
the highlighted directory - displaying a scrolling window of files and
sizes, grouped by EXTENSION.

Hitting any key will cause the light bar to jump to the first entry
beginning the with that letter.

                      File List by Extension ("Drill Down")
                      -------------------------------------

Hitting enter (or clicking the left mouse button with the cursor on the
OK box) opens up a third scrolling window of FILE NAMES containing the
hilighted extension.

This window is also sortable by FILENAME or by SIZE.

Individual files in this third scrolling window may be deleted
by hitting the DEL key, or clicking on the DEL literal.

                               Printing the Report
                               -------------------
Hit the F8 key, or click on the "*" on the bottom line to print the Tree
Map Report. A dialog box will prompt you to enter an optional Machine ID,
which is useful if you manage several different machines. If using a mouse,
you can click within the dialog box to get the on screen keyboard, and type
in the Machine Id entirely with the mouse.

                          Program Launch & File Browse
                          ----------------------------

Hitting ENTER when in the third scrolling window will allow you
to RUN ("launch") the highlighted filename if it is a program (has a file
extension of "EXE" or "COM". A Dialog box will popup, in which you can
enter run time (or Command Line) parameters. If you have a mouse, you can
"click" inside the dialog box (not on the OK button) and you will get an
"on screen keyboard" so you can type in the parameters with the mouse!

Note: If the parameters and the program name exceed 16 characters the
keyboard buffer will fill up, and you will have to re-type any additional
characters at the DOS prompt.

If the highlighted filename has an extension other than "EXE" or "COM", DAAG
will Browse the file provided that you have a browse program named "SHOW.COM"
or SHOW.EXE available along your search PATH.

Any browse program that expects the filename on the command line should work.
Just make a copy of it in a directory that is in your PATH, and rename the
copy as "SHOW.COM" or "SHOW.EXE", depending on program type.

One of the best browse programs available is a shareware program
named LIST.COM, by Vernon Buerg, 456 Lakeshire, Daly City, CA 94015.
Most BBS's carry this excellent program.
LIST can be called from DAAG nicely; just remember to rename it
"SHOW.COM", and have it in your PATH.

                                   SHOW.EXE
                                   --------

For people that do not have LIST.COM, enclosed with DAAG is a workable
but limited browse program called "SHOW.EXE". It is not as good as
LIST.COM, but is included for anyone who does not have a stand alone
browse program. It cannot browse files larger than 65,537 (64k) bytes.

SHOW.EXE does not recognize the Mouse.

                               F7 - Regen Tree
                               ---------------

The DAAG statistics are only as current as your last "snapshot". Periodically,
you should take a new snapshot to bring you Tree Map up to date. Hitting
(or clicking with the mouse on) F7 will create a new snapshot and make the
tree map current.

                                The MAP File
                                ------------

The first time DAAG runs, it will scan your disk and create a "snapshot"
of your directory structure (tree map).

Normally, DAAG stores the tree map in a disk file called "DAG3.TRE", in
your ROOT Directory.

On some networks you do not have "rights" to the root directory.

If you do not want DAAG to store this file in the root directory, then
create a subdirectory named DAAG. (Type "CD\", then type "MD DAAG").

DAAG checks for a directory name of "\DAAG". If it exists, it stores the
tree map file there. Otherwise, it stores it in the root directory.


                               Renaming DAAG
                               -------------

If you get into the habit of using DAAG instead of the great "CD\"
command to change directories, then I recommend that you rename
DAAG to a one letter name, like "D".

(To do this, at the DOS prompt, type "REN DAAG.EXE D.EXE").

Then from DOS, you simply type "D", followed by the first significant
letters of the directory name, then SPACE BAR to change quickly to that
directory.

                          Changing the Color Scheme
                          -------------------------

There is no longer a color installation program for DAAG. Rather, there are
5 predefined color combinations (palettes) from which to choose.
You specify which palette to use in one of two ways:

 1) Enter a number from 1 to 5 on the command line after "DAAG".
    For example, type "DAAG 3" to see DAAG with color combination number 3.

 2) Add the line "SET DAAG=n" (where n is a number from 1 to 5) to your
    AUTOEXEC.BAT file. This will create an environment variable called DAAG
    that contains the value of the desired palette.
    (Note: You will have to reboot your system in order for the change in
    your Autoexec.bat file to take effect).

                            MEMORY REQUIREMENTS
                            -------------------

DAAG requires about 370k of memory.


                     A note on adding up the file sizes
                     ----------------------------------

Notice that the sum of all directories (the Cum. Size for the ROOT
Directory) is not exactly equal to the FREE Space listed at the bottom
of the screen (total disk size minus the space available). This is because
DOS allocates file space in CLUSTERS (usually 2048 or 4096 bytes to a
cluster). Even a 20 byte batch file will actually use 2048 or 4096 bytes
(depending on cluster size).

Warranty:
---------

There is no warranty, period.
Steve Leonard specifically disclaims all warranties, expressed or implied.

Use this product at your own risk.

In no event shall Steve Leonard be liable for any loss of profit,
or any other damages or loss incurred because of this product.


Distribution of this program:
----------------------------

This program may be used by anyone FREE of charge, for an initial 10 day
evaluation. Additionally, it may be distributed by Shareware companies
for a reasonable fee.

The only requirement is that this DOC file is included, and not altered.

If you continue to use this program after an initial 10 day evaluation
period, then you are required to send a $15 payment to :

                             Steve Leonard
                             212 Green Springs Ln.
                             Madison, AL 35758

              I may be reached on Compuserve at : 73557,203

                         Benefits of Registration
                         ------------------------

   1. You are fulfilling a moral obligation. The author has spent over
      $1000 on compilers, toolboxes, and books required to write this
      program, as well as hundreds of hours of time. Since you are given
      the opportunity to try the program first, why not pay for its
      continued use?

   2. You will receive a BONUS DISK, containing the latest version
      of the program, along with some other utility programs that I have
      written, including:

      *  NUSTUFF, an ancient by still useful utility that scans your entire
         hard disk for files that are a user-specified number of days old.
         Good for finding that file you created last week, but can't
         remember what you called it, or where you put it.

      *  View2, a text file compare utility that lets you browse 2 files
         side by side, each in its own resizable window. Perfect for
         programmers who need to compare the current program to the "*.BAK"
         file. Lets you manually resynch the compare when large blocks of
         code have been added or deleted.

      *  CHAAG (Charts-at-a-Glance). This program draws hierarchical
         charts directly from text files, using indentation to denote levels
         of subordination. Turns your outlines into pictures.

      *  VO (View Open) - A memory resident program that shows what files
         are open at any point in time. Useful for programmer debugging or
         just general snooping. See what files that program is using.

      *  LASER1 - prints single mailing labels to laser printers. It allows
         you to specify which position on the sheet to print to, so that
         you can later reuse the same sheet, printing to a different
         position. Is memory resident and uninstallable, so that your
         existing applications can print a single label to the laser printer.
         You create a config file, indicating which positions on the screen
         to capture the data from. works only for 1 3/4" by 4" (2 up)
         labels, such as AVERY 5262.

      *  My "Super Mouse" program, that lets you uses the mouse from the
         DOS command line.

         Many programs today are mouse aware, but you still have to type in
         the program name from the keyboard just to fire up the program.
         This handy utility allows you to type with the mouse, by clicking
         on the desired letters of an "on screen" keyboard.

         It also provides command line recall, activated only by the mouse!

         It requires only 6k of RAM, and also needs about 50k of EMS.
         (Technically, it is not a TSR, but a shell).

  All programs will be in ZIP format on a 5-1/4 inch DSDD floppy disk.

                         Attention Corporate Users:
                         --------------------------

   Why not buy a DAAG "site" license and use DAAG on all your machines?
   Printing the Tree Map is an easy way to track what is installed on which
   machines.

   The cost is minimal:   Unlimited machines $149